home *** CD-ROM | disk | FTP | other *** search
/ Space & Astronomy / Space and Astronomy (October 1993).iso / mac / GDS / GDS-DEMO.DOC < prev    next >
Text File  |  1991-10-10  |  48KB  |  903 lines

  1.                       GDS - Graphics Display System
  2.  
  3.                    Imaging Software by Raxsoft Systems
  4.                 Distribution by Phase II Electronics Inc.
  5.                    Copyright (c) 1990,1991 Paul Schmidt
  6.                      Copyright (c) 1990,1991 Raxsoft
  7.                            All rights reserved.
  8.  
  9.  
  10.                                  CONTENTS
  11.  
  12.             Legal Notices                                   I
  13.             GDS Features And Requirements                  II
  14.             GDS Limitations                               III
  15.             Notes About Use                                IV
  16.  
  17.             Getting Started                                 1
  18.             The GDS Screen                                  2
  19.             Viewing Commands                                3
  20.             Slide Shows                                     4
  21.  
  22.             Arrays                                          5
  23.             Antialiasing                                    6
  24.             Dithering                                       7
  25.             Command Line Parameters                         8
  26.             Configuration File Details                      9
  27.             Common Problems And Solutions                  10
  28.             Additional Customer Support                    11
  29.             Introduction & Revision History         GDSINFO.DOC
  30.  
  31.  
  32.         GDS is available in 3 flavors:
  33.  
  34. 1. This "Demo" version which is free and will provide most people with 
  35. everything that they need.
  36.  
  37. 2. The "Registered" version for $35.00 Includes AUTOMATIC UPDATES FOR ONE
  38. YEAR.  (That's right, you don't even have to call us!) additional functions
  39. and a printed users manual.  (Commands found only in the registered version
  40. are marked with **)
  41.  
  42. 3. The "Professional" version which presently provides full support for the
  43. Epson ES300C color scanner with many features not found in other scanning
  44. packages.  Cost of licensing is $249 with a rebate of $35 if you have already
  45. registered the "User" version.
  46.  
  47.         Distribution and support services provided by:
  48.  
  49.             Phase II Electronics Inc.
  50.             19 Sands Point Drive
  51.             Toms River New Jersey 08755-5167
  52.             Phone (908) 286-0080,  Fax (908) 349-3842
  53.             Compuserve 76667,1522  Bob Holland
  54.  
  55. I. Legal Notices
  56. ---------------------------------------------------------------------------
  57. /////////////////////////////// W A R N I N G ! ///////////////////////////
  58. ---------------------------------------------------------------------------
  59.    The AUTHOR and/or DISTRIBUTORS of GDS DO NOT ASSUME ANY RESPONSIBILITY OR
  60. ANY LIABILITY FOR ANY LOSS OR ANY OTHER EXPENSE OR INCONVENIENCE CAUSED BY
  61. ANY BETA VERSIONS OF GDS.
  62.    This includes ALL versions.  NOTE: GDS103.ZIP (marked as version "1.03")
  63. which circulated unintentionally contains several known (and potentially
  64. damaging) bugs removed from later versions.  If you have a version before
  65. version 1.04, ERASE IT; DO NOT USE IT.
  66.    The original file containing GDS may be distributed and used freely
  67. without ANY modifications to the program and/or included documentation.
  68.    Any changes to the original distribution files will be considered an
  69. infringement on the rights of the author, and may be subject to criminal
  70. and/or civil prosecution.
  71.    Any attempt to disassemble and/or extract code from this product will be
  72. considered copyright infringement punishable by law.
  73.    Users may not derive financial benefit from this software in any manner.
  74. They may not sell it or bundle it with any combination of products sold for
  75. profit.  (This does not include shipping charges for shareware distributors).
  76.    Phase II and associates hereby disclaim all warranties relating to this
  77. software, whether express or implied, including without limitation any
  78. implied warranties of merchantability or fitness for a particular purpose.
  79. Phase II will not be liable for any special, incidental, consequential,
  80. indirect or similar damages due to loss of data/damage to hardware or any
  81. other reason, even if Phase II or an agent of Phase II has been advised of
  82. the possibility of such damages.  In no event shall Phase II's liability
  83. for any damages ever exceed the price paid for the license to use the
  84. software, regardless of the form of the claim.  The person or persons using
  85. the software bear all risk as to the quality and performance of the
  86. software.
  87.  
  88. II. GDS FEATURES AND REQUIREMENTS
  89.  
  90. 1) GRAPHICS VIEWER
  91.   GDS is a graphics file viewer with a very intuitive user interface.
  92.  
  93. 2) FILE FORMATS
  94.   GDS reads GIF87a, GIF89a (including comments), BMP, LBM, PCX, RIX, and 
  95. MAC files.  It can write GIF87a, **LBM, **BMP, **PCX, and **RIX files 
  96. directly from the screen.  Other formats may be added in future versions.  
  97. If you need a read or write format supported, FAX or write to Phase II 
  98. Electronics Inc.  **Registered version only 
  99.  
  100. 3) SLIDE SHOWS
  101.   GDS will queue up to 2800 images to show in a repeated sequence.  GDS
  102. reads successive images ahead of time into EMS or system RAM to minimize
  103. draw time, increasing the appearance of the slide show.
  104.  
  105. 4) IMAGE PROCESSING
  106.   GDS can lock a screen mode, reduce and enlarge images to fit, or scale and
  107. zoom to almost any dimensions.
  108.   GDS quickly converts 256-color images to 16-color images with antialiasing
  109. and dithering to ensure spatial color consistency.
  110.   GDS can scale images to almost any size.  It will reduce, enlarge, or
  111. correct image scaling.
  112.  
  113. 5) ARRAYS
  114.   GDS has an image cataloging section which reduces and labels arrays of
  115. images on the screen.  It creates spatially optimized palettes, uses **two
  116. levels of dithering and **two dimensional antialiasing to reduce color
  117. distortion, and can reduce up to 2304 images onto a single 1024x768
  118. graphics screen.  If you are a system operator of a BBS, this is a great
  119. way to provide previews of many images in a single, downloadable file.
  120. **Registered version only (1 level in shareware distribution version)
  121.  
  122. 6) MOUSE SUPPORT
  123.   Although ALMOST everything can be done with the keyboard, a mouse is
  124. highly recommended.  Version 1.10 has Mouse "pull-down" menu's when in 
  125. the view mode.
  126.  
  127. 7) HARDWARE SUPPORT
  128.   GDS takes great pains to support video hardware, and supports most SVGA
  129. boards.  A few chipsets still remain questionable, but GDS covers the
  130. majority of display hardware.
  131.   GDS can also be adapted to work with OEM cards using unrecognized
  132. manufacturer markings, so if you have an unsupported card, there is a good
  133. possibility that it can function completely.
  134.   GDS is capable of supporting extended 24-bit DAC circuitry which can
  135. provide 16,777,216 colors, rather than 262,144.
  136.  
  137. 8) MEMORY REQUIREMENTS AND USAGE
  138.   GDS can make use lots of memory, using EMS to increase the speed of slide
  139. shows.  If your machine has less than 450K of available system RAM, GDS will
  140. probably not perform as well as it can (colors choices in array generation
  141. will be severely degraded and GDS may kick you out to DOS completely).  GDS
  142. makes good use of EMS 3.2 and available high DOS memory.  We strongly
  143. recommend a 640K system with at least 64K of EMS.  XMS is not supported as
  144. it does not provide tolerably fast memory swapping.
  145.  
  146.  
  147. III. GDS LIMITATIONS
  148.  
  149. 1.  GDS makes no attempt to read or write TIFF files.  See FILE FORMATS in
  150.      part II above.
  151. 2.  GDS doesn't write BBM or MAC files.  See FILE FORMATS in part II above.
  152. 3.  GDS is not a PAINT/DRAW program.
  153.  
  154. IV. NOTES ABOUT USE
  155.  
  156. SYSOPS:  GDS is an excellent method for cataloging your GIFs.  A single 185k
  157. file can contain hundreds of images and their file names as a preview of
  158. your directory.  Please inform Phase II of how you are currently using GDS
  159. and any suggestions for improvements.
  160.  
  161. We encourage all users to distribute and use the demo version FREEly.  If
  162. you would like the enhanced version and future updates or intend to use GDS
  163. for commercial purposes, you MUST register.
  164.  
  165.  
  166. 1. GETTING STARTED
  167.  
  168.   Start GDS by typing "GDS" followed by "ENTER."  GDS can be run with or
  169. without command line options and can be started from any directory by
  170. specifying its path on the command line.  It can also be run if it's in the
  171. DOS environment's PATH.
  172.   GDS parses file/path specifications and runtime switches as command line
  173. parameters.  Any number of paths/files may be specified to GDS.  The
  174. following command line is typical:
  175.  
  176. C>  GDS i:\dp\*.lbm j:\GIFs myimage.gif
  177.  
  178.   The first path specifies all LBM files in the DP directory on drive I:.
  179. The second path specifies all readable files in the GIFS directory on drive
  180. J:.  The third path specifies the single file MYIMAGE.GIF in the currently
  181. logged directory.  If no path names are given, the current directory is used.
  182.  
  183.   If you have problems getting GDS to run, refer to the section entitled
  184. COMMON PROBLEMS AND SOLUTIONS.
  185.  
  186.   If you'd like to get going with GDS as fast as possible, given its very
  187. intuitive interface, after you've read the next four paragraphs, you've
  188. probably read enough to use most of what GDS does.  Start and experiment,
  189. but come back and read the rest of the documentation.  GDS does so much that
  190. it's impossible to explain it all in 100 or fewer words.
  191.  
  192. 2. THE GDS SCREEN
  193.  
  194.   After configuration, GDS presents a screen containing a display consisting
  195. of file names, extensions, and file sizes in a columnar format.  The top line
  196. shows the version number, registered user's name and phone number, and
  197. copyright message.
  198.  
  199.   To view images in "Single" mode (see "VIEW:" below), press "ENTER" or
  200. double click the mouse on a file name.  Single clicking on a file will
  201. deselect all currently selected files and select the file under the mouse
  202. cursor.  In single view mode, mouse users may toggle ranges of files by
  203. holding down the shift key and clicking/dragging.
  204.  
  205.   In "Slide Show" or "Array" mode, use the arrow keys to move to a filename,
  206. the spacebar to select or unselect it.  Mouse users can drag the mouse from
  207. one file to another to select all files in between.  In the slide show mode,
  208. the mouse always acts as though the shift key is held.
  209.  
  210.   Pressing the ENTER key starts a view in the current view mode (single or
  211. slides) without  changing the selection state of ANY of the
  212. files in the file list.  Double clicking the mouse on a file will display
  213. that file alone, regardless of the current view mode.  Use the ENTER key or
  214. view button (see below) to initiate slide shows.  It's usually easier to set
  215. up fragmented slide shows with the keyboard than with the mouse.
  216.  
  217.   Several buttons and menus are displayed in the second and bottom lines of
  218. the screen.  These areas are referred to as "menu areas."
  219.  
  220.   The "file status area," between the file display and the bottom menu area,
  221. displays detailed information about the Current File.  As the file cursor is
  222. moved through the file list, GDS displays information about each file.  This
  223. information includes the complete path and file name of the file, its screen
  224. resolution, number of colors, and exact file size in bytes.
  225.  
  226.   The right side of the file status area displays the total number of files
  227. and number of files selected, if any.
  228.  
  229.   Directly to the right of the file status area is the "view button" which
  230. says "ENTER views current selection" in a rectangle.  This button merely
  231. tells keyboard users what to do to display an image, but allows a mouse to
  232. click on it to start a slide show.  If there is more than one file selected
  233. or NO files selected, the view button starts a slide show.  If only one file
  234. is selected, the view button will do a single view.  For mouse users, it's
  235. easier to use the "View:" menu to change the behavior of single clicks in
  236. the file list (see above) and use the view button to start slide shows.
  237.  
  238.   To use the menus, hold down the ALT key and then hit the key which matches
  239. the highlighted character in the menu or button you want to change, or click
  240. on it with a mouse.  If the menu or button you have selected has two or fewer
  241. functions (like the MOUSE: button), the state of the button changes.  If it
  242. has more than two choices, GDS presents a menu.  When using the keyboard, the
  243. default menu selection will be highlighted.  Use the arrow keys to navigate
  244. the menus and press ENTER to select your option.  ESC will cancel a selection
  245. from a menu.  With a mouse, just click (or drag and let go) on your choice;
  246. to cancel a selection, just click (or let go) outside of the menu area.
  247.  
  248.   When any alphanumeric key (not associated with special CTRL or ALT
  249. commands) is pressed, GDS looks through the current list of files and moves
  250. the cursor to the first file starting with the same character as the key
  251. pressed.  If GDS can't find a file that matches, it will put the cursor on
  252. the closest match it can find.
  253.  
  254.   GDS supports CTRL key commands allowing the user a great deal of
  255. flexibility of file control.  When the CTRL key is pressed, GDS pops up a
  256. green window at the bottom of the screen showing which control keys do what.
  257. These options are as follows:
  258.  
  259. **     Ctrl-C  Copy File         duplicates a file in another drive/path
  260.        Ctrl-D  Delete File       deletes a file forever
  261. **     Ctrl-F  New File List     specifies a new path/file list
  262. **     Ctrl-H  Hide file         removes a file from file list
  263.        Ctrl-L  List Comments     list comments in a GIF89A file
  264. **     Ctrl-R  Rename file       changes the name of file
  265. **     Ctrl-S  System Status     displays free space on disk
  266. **     Ctrl-T  Transfer file     moves a file to another drive/path
  267. ** Registered version only
  268.  
  269. GDS COMMANDS
  270.  
  271. Quit   (or ESC)           This button exits the program.
  272.  
  273. AutO/LOck
  274.   This button shows the state of screen mode locking.  The default graphics
  275. mode (set with "RES:") is meaningless when viewing in AutO mode.  Locking the
  276. screen mode forces images to be displayed in the graphics mode selected in
  277. the "RES:" menu.  This is handy when reducing large images to fit in smaller
  278. screen modes, or reducing 256-color images to dithered 16-color images.
  279.  
  280. Res:???x???x?
  281.   This menu allows the selection of the default graphics and text modes.
  282. The default graphics mode has no effect on viewing unless the "AutO/LOck"
  283. button is in the "LOck" state.  It does, however, determine the resolution
  284. of files written with the ALT-keys.
  285.  
  286. View:
  287.   This menu allows the user to choose between "Single" images, "Slides" 
  288. (slide shows) and "Arrays." In "Single" mode, any selection of a file 
  289. will deselect all other files first (unless the SHIFT key is held).  In 
  290. "Slides" mode, mouse clicks are never globally destructive to selections; 
  291. they always add to the selected files.  Double clicking the mouse always 
  292. produces a single view regardless of the state of this menu. "Arrays" 
  293. mode creates (and can write) arrays of multiple images.  
  294.  
  295. Alias:
  296.   This menu allows the user to select the level of antialiasing performed
  297. for reduced images (see ANTIALIASING below).  HINT: The default antialiasing
  298. (horizontal only) is almost as fast as no antialiasing at all.  **High
  299. quality image reduction can take in excess of 5 times longer depending on
  300. the level of reduction.  In general, considering the increase in image
  301. quality, it's always worth using horizontal antialiasing.
  302. **Registered version only
  303.  
  304. AboUt:
  305.   This menu displays information about GDS.  It has no viewing function.
  306.  
  307. SORT:
  308.   This menu allows the user to select the sort order for the file display.
  309. Selecting a new sort order immediately rearranges the file display.
  310. Selecting sort orders which require the resolution or number of bits per
  311. pixel will force GDS to read this information before a sort can be done.
  312. This is time consuming, but GDS can't sort information it doesn't have.
  313. Fortunately, GDS buffers the resolution and number of bits per pixel so that
  314. it reads them only once.
  315.  
  316. MOUSE:
  317.   This button toggles the mouse between a bitmapped text cursor and a
  318. character cursor.  Some video displays do not conform to the VGA hardware
  319. standard for text character sets and may cause GDS to display a garbled
  320. mouse cursor.  If this happens, click on the "MOUSE:" button.  The state of
  321. the mouse can be set in the configuration file so you don't have click the
  322. "MOUSE:" button every time you run GDS.
  323.  
  324. DITHER:
  325.   This menu allows the user to specify the level of dithering to be used
  326. when generating array images.  No dithering means that GDS will not try to
  327. increase color consistency.  Two-color dithering generates checker-board
  328. patterns which are imperceptible except in low resolution graphics modes.
  329. **Uneven dithering is more obvious than two-color dithering, but greatly
  330. enhances the general look of 16-color renditions of images which start out
  331. with many more colors.  There is almost no speed difference in using
  332. dithering.  The biggest delay is the delay just before the image is read
  333. where GDS generates its conversion table.  There is almost no speed
  334. difference in putting up raw pixels vs. dithered pixels.  In short, dithering
  335. doesn't slow GDS down perceptibly.
  336. **Registered version only
  337.  
  338. FILESHOW:
  339.   This menu allows the user to toggle elements (Resolution, Extension, Size,
  340. Bits) of the file display on and off.  These elements can be set in the
  341. configuration file so you don't have to set it every time you run GDS.
  342.  
  343. 3. VIEWING COMMANDS
  344.  
  345.   Single images can be viewed alone by pressing ENTER or by double clicking
  346. a file with a mouse.  When viewing, you can adjust the palette manually (see
  347. F-key description below).  Every time a level is changed, the entire palette
  348. is recalculated from the original to prevent eventual palette degradation.
  349.  
  350. Esc     Always exits view mode.
  351.  
  352. Enter   Exits single view mode; advances to next image in slide shows.
  353.  
  354. Spacebar:
  355.   When viewing a single image, pressing the spacebar exits back to the file
  356. screen unless the scale of the image is not exactly the same as the original
  357. image (Note: If image is auto scaled by setting the /E switch, the spacebar
  358. will return the scaled images to their original scale).  In array generation
  359. mode, the spacebar will stop the display of any images in progress and skip
  360. directly to the next image in the list.  The spacebar also toggles the
  361. selection state of the file under the file cursor.  Combining the arrow keys
  362. and the spacebar allows selection of images for slide shows and arrays.
  363.  
  364. Alt-W:
  365.   Immediately starts writing a GIF file titled GDS###.GIF.  The number used
  366. in place of "###" is either 000 or whatever number was specified with the
  367. "/W###" **command line parameter.  This function will not overwrite existing
  368. files.  You can use the "/N<template>" **command line parameter to change the
  369. name template for the files which are written.
  370. **Registered version only  Demo version automatically saves to GDS###.GIF.
  371.  
  372. **Alt-L:  Exactly like Alt-W, but writes "LBM" files.
  373. **Alt-P:  Exactly like Alt-W, but writes "PCX" files.
  374. **Alt-R:  Exactly like Alt-W, but writes "RIX" files.
  375. **Alt-B:  Exactly like Alt-W, but writes "BMP" files.
  376. **Registered version only
  377.  
  378. NOTE:  Alt-R uses the extension ".SC<c>", where <c> is the screen resolution
  379. indicator as prescribed by RIX Software in Irvine, California.  GDS supports
  380. RIX's "UNCOMPRESSED" format only.  RIX Software is not releasing ANY
  381. information about its compressed formats.  If you would like to see
  382. compressed RIX file support, please ask RIX to allow developers to support it.
  383.  
  384. Arrow keys:
  385.   The arrow keys move the cursor when selecting files.  They also adjust the
  386. position of the lower right hand corner of the image rectangle when viewing a
  387. file.  Using the arrow keys alone moves the lower right corner by two pixels
  388. at a time.  **Holding the shift key down while using the arrow keys moves it
  389. by 20 pixels at a time.  If you manage to get the image messed up enough to
  390. start over, hit the space bar and the image will redraw at its default scale.
  391. This function is useful when used with Alt-F to fine tune the scale for image
  392. reduction.  It's also very useful for correcting the size of images that are
  393. stored with an odd screen size.
  394. **Registered version only
  395.  
  396.    E     These keys pan the viewing area in the direction indicated by the
  397.  S-+-D   placement of the keys on the keyboard.  One keypress normally
  398.    X     moves the image by one dot.  When the shift key is held down, the
  399.          image moves by 20 dots at a time, similar to the behavior of the
  400.          arrow keys as described above.
  401.  
  402. **ALT-Z:
  403.   Start "zoom" sequence (only with a mouse).  Use ALT-Z as follows:
  404. (1) Press ALT-Z.
  405. (2) Move the mouse pointer to the upper left of the desired zoom rectangle.
  406. (3) Press and hold down a mouse button.
  407. (4) While holding down the mouse button, drag the mouse pointer to the lower
  408.      right of the desired zoom rectangle.
  409. (5) Release the mouse button.  The zoom function will preserve the current
  410.      X to Y ratio for scaling in case you've adjusted it or used ALT-F to
  411.      fit the image to the screen.  If you manage to zoom to the wrong place
  412.      or mess things up beyond comprehension, just hit the space bar to
  413.      redraw the image at its default scale.
  414. **Registered version only
  415.  
  416. Alt-F:
  417.   Fit image to screen.  This function ATTEMPTS to rescale an image to fit
  418. into the full screen.  It is useful for scaling images down from large
  419. screen sizes.  Depending on the dimensions of the image, this may not
  420. produce the desired results.  If the aspect ratio of the graphics mode or
  421. image is not recognizable by GDS, the image may be distorted.  If this
  422. happens, use the spacebar to redraw the image at its original scale and
  423. manually adjust the scale of the image using the arrow keys.
  424.  
  425. F1/F2   Reduce/Increase palette red level.
  426. F3/F4   Reduce/Increase palette green level.
  427. F5/F6   Reduce/Increase palette blue level.
  428. F7/F8   Reduce/Increase contrast.
  429. F9/F10  Reduce/Increase brightness.
  430. ","/"."       Reduce/Increase color.  This function can reduce a full color
  431. image to grey scale by using "," to eliminate all color content completely.
  432. The image can further be reduced to a monochrome image by increasing the
  433. contrast to maximum (F8).  This color level control compensates for the eyes'
  434. responsiveness to red, green, and blue for minimal color distortion.
  435.  
  436. Shift-F1/F2     Reset red level to that of original image.
  437. Shift-F3/F4     Reset green level to that of original image.
  438. Shift-F5/F6     Reset blue level to that of original image.
  439. Shift-F7/F7     Reset contrast to that of original image.
  440. Shift-F9/F8     Reset brightness to that of original image.
  441. Shift-","/"."   Reset color to that of original image.
  442.  
  443. 4. SLIDE SHOWS
  444.  
  445.   GDS has two separate methods of generating slide shows.  The first is to
  446. select a range of files from within the normal GDS user interface and set
  447. the "View:" menu to "Slides".  When GDS is in set this way, normal viewing
  448. of images results in a slideshow (except for mouse double clicks; see VIEWING
  449. COMMANDS).
  450.  
  451. **The following is only available in the Registered version.
  452. **Note... Due to popular demand the following Slide Show options have 
  453. been activated in the Free or Demo version of GDS 1.10.
  454.  
  455.   The second method is to specify the "/S" option on the command line.  GDS
  456. will bypass the normal user interface and immediately start a slide show
  457. using any files specified on the command line.
  458.   The "/O" option is normally ON (1), which sorts the file list when the
  459. "/S" option is specified.  Specifying "/S0" on the command line will
  460. prevent GDS from sorting the file list.
  461.   The "/Z" option specifies the delay in 100ths of seconds between slides.
  462. Two seconds, for example, would be specified using "/Z200".  If "/Z" is
  463. not specified, GDS will wait for at least 5 seconds between each slide.
  464.   The "/E" option is used to tell GDS to fit all images onto the screen
  465. during slide shows.  This is useful when you have limited video capability
  466. and, at the same time, need to do a slideshow with many files which are much
  467. larger than the maximum resolution you can display.
  468.   It is often necessary to give a slideshow on a very specific set of files
  469. which may be inconvenient to enter on the command line.  The "@<FILE>"
  470. option is used to tell GDS to read a list of filenames from <FILE>.  Using
  471. the "@<FILE>" option can save you a lot of time and allow you to customize
  472. your slideshows to your heart's content.  An example of a typical planned
  473. slideshow is as follows:
  474.  
  475.   C>  gds /s @filelist /o
  476.  
  477.   The first option ("/s") tells GDS to do an automatic slide show.  The
  478. second option ("@filelist") tells GDS to read the file FILELIST for a list
  479. of files to show.  The third option prevents GDS from sorting the file list.
  480.  
  481. 5. ARRAYS OF REDUCED IMAGES
  482.   GDS allows the creation of arrays of multiple reduced images.  Select the
  483. files you wish to see (or select none to see all), then choose "ARRAYS" from
  484. the "View:" menu.  In the array window, you may toggle borders and labels on
  485. and off, and increase or decrease the number of images.  (Setting the borders
  486. and labels off results in slightly larger images.)  Hit return or click
  487. on the option to draw the array.  (See the ALT-key section for writing the
  488. array to a file and the F-key section for altering the colors/densities.)
  489.  
  490. 6. ANTIALIASING
  491.  
  492.   Antialiasing is a term used to describe the color correction applied to
  493. pixel hues in order to maintain the overall appearance of an image.  Most
  494. often, antialiasing means adjusting the colors along partially covered pixel
  495. when drawing a line on a bitmapped screen.  GDS uses antialiasing only when
  496. reducing an image.  It doesn't smooth out transitions between enlarged pixels.
  497.   GDS uses a **very high performance antialiasing technique which scans colors
  498. from many original image pixels and combines them to form a single
  499. destination pixel.  This technique represents the original image extremely
  500. accurately but uses far fewer dots to do it.
  501.   An interesting side effect of antialiasing is that it tends to reduce the
  502. size of the resulting GIF file by about 9.6% for each dimension of
  503. antialiasing applied.
  504. **Registered version only.  Demo version has only 1 level of antialiasing.
  505.  
  506. 6. DITHERING
  507.  
  508.   GDS normally mixes colors together when appropriate to increase the apparent
  509. color resolution.  A good example of this is if an image has a section which
  510. fades evenly from one color (like red) to another color (like blue).  The
  511. result in the middle is purple.  When images are reduced and combined on the
  512. same screen, the demand for colors is high.  High resolution GIF images
  513. contain 256 colors per picture.  Mixing 80 pictures together would require
  514. 20480 colors to represent the pictures without any hardware color distortion
  515.   When GDS doesn't have a color available (like purple from the example above),
  516. it looks for two colors which, when displayed, closely together appear to have
  517. the color of the original pixels.  This results in an almost imperceptible
  518. change from the original color in 256-color modes.
  519.   Normally, two-color "even" dithering is enough (especially with 256-color
  520. images).  But when forcing 256-color images into 16-color screen formats, a 1:3
  521. dithering scheme works better.  This scheme uses three pixels of one color and
  522. one dot of another color if the resulting color is significantly closer than
  523. anything else found.  **This mode produces significantly better reduced palette
  524. images than two by two dithering.
  525.   Opposite of the effect antialiasing has, dithering increases GIF file size by
  526. about 9.6% for each level of dithering applied.
  527. **Registered version only  Demo version has only 1 level of dithering.
  528.  
  529. 7. COMMAND LINE PARAMETERS
  530.  
  531.   All command line parameters may be prefaced with a forward slash ("/") or
  532. a dash ("-").  Command line parameters are processed in the order they are
  533. received.  Basically, they act like most other command line schemes.
  534.  
  535. Available command line options are as follows:
  536.  
  537. /B<n>   Sets mode of mouse cursor.  When is set to 0, GDS will display a
  538.         highlighted character as a text mouse cursor.  When set to 1, GDS
  539.         will attempt to remap characters in the EGA/VGA  character set to
  540.         implement a graphics cursor in text mode.  The default setting is
  541.         determined at runtime, and depends on your hardware.  If your cursor
  542.         doesn't look right, try changing the /B option in your GDSUSER.CFG.
  543. /C<n>   Specifies the number of bits to use for the individual color bars in
  544.         each color register entry.  GDS defaults to 6 bits (or 18-bit color),
  545.         writing directly to the VGA hardware (unless running with an EGA).
  546.         IF YOU HAVE ANY COLOR PROBLEMS, try using "/C0", which forces GDS to
  547.         use the video BIOS to set the palette.  Some SVGA boards have 8-bit
  548.         DACs, which make it possible to use the full 24 bits of color
  549.         resolution which GDS is capable of.  When a display adapter is using
  550.         an 8-bit DAC, GDS (defaulting to "/C6") will display images about
  551.         four times dimmer than they should be.  This can be remedied by
  552.         using either "/C0" or "/C8" (works only if DAC hardware is pseudo-
  553.         VGA compatible).  GDS supports any VGA re gister compatible DAC chips
  554.         with any number of bits per color bar from 1-8.  Do odd numbered
  555.         DACs exist?  I suppose the TARGA style DACs are 15-bit, but I'm not
  556.         sure if these do 15- or 16-bit colors.
  557. /D<n>   Sets the default dithering level.  When working with many colors, it
  558.         is best to use dithering level 1 to preserve general color
  559.         appearance.  If working with 16-color images, GDS can be set to
  560.         dither level 2, which gives 256-color images more quality when they
  561.         are forced into a 16-color mode.  The default dither level is 1.
  562. /E<n>   Sets image/screen fit mode (0=normal, 1=fit to screen) 
  563. /H or /?  Display help screen with these switches listed
  564. /R<n>   Set default resolution "LOck/AutO" mode (0=AutO, 1=LOck)
  565. /V<n>   Set mode of file directory (0=vertical, 1=horizontal listing)
  566. /<NAME> Forces GDS to assume it has the named video card.  Normally, this
  567.         is not necessary or advisable.  Use this option only if GDS does 
  568.         not recognise your video card.  Use the Alt-R option and Alt-O to 
  569.         lock in the screen modes.  Then test each mode to find out if your 
  570.         selection is fully compatible with your video csrd.  The following
  571.         video cards are currently defined:
  572.  
  573.         /EGA       Standard EGA or 100% compatible
  574.         /VGA       Standard VGA or 100% compatible
  575.         /AHEAD     Ahead Systems Chipset (type A)
  576.         /AHEADB    Ahead Systems Chipset (type B)
  577.         /ATI       ATI VGA Wonder
  578.         /CHIPS     Chips and Technologies Chipsets
  579.         /EVEREX    Everex Systems
  580.         /GENOA     Genoa 6000 series
  581.         /OAK       Oak Technologies
  582.         /ORCHID    Orchid Technologies
  583.         /PARA      Paradise Systems
  584.         /TRIDNT    ATI Prism Elite (Trident Chipsets)
  585.         /TSENG     Tseng Laboratories Chipset
  586.         /TSENG4    Tseng Laboratories Chipset (4000 series)
  587.         /VESA      Standard VESA BIOS Interface
  588.         /VID7      Video Seven VRAM or FASTWRITE VGA
  589.         /ZYMOS     Zymos HiRes 512K VGA
  590.   NOTE: If you have any problems with the video modes listed in GDS.CFG, or
  591.         find discrepancies, please FAX or write me a note.
  592.  
  593. /512    Forces support for more that 256k VGA ram.  If your video card has 
  594.         more than 256K of display RAM and you are unable to get GDS to
  595.         support the extra ram, try using the "/512" command line switch.  
  596.         If using this option is successful, you may wish to place this 
  597.         switch in GDS.CFG.  The default setting of this switch is 0 
  598.         (off), and if /<NAME> is not specified, this switch is set by GDS 
  599.         when it tries to automatically detect what type of video adapter 
  600.         is present.  
  601.  
  602. /!<n>     **Enable/disable beep after display of image (0-1)
  603. /A<n>     **Set default antialiasing level (0-2)  level 2 registered only
  604. /F####    **Set default file display options
  605. /G<mode>  **Set default graphics display mode
  606. /I<n>     **Set early interlaced fill mode 
  607. /K<n>     **Set automatic GIF89a comment display flag
  608. /L<n>     **Set default labels on/off switch
  609. /M<n>     ****Set maximum number of colors in generated palette NOT
  610.             CURRENTLY SUPPORTED on any version of GDS.
  611. /N<temp>  **Set template for filename generation
  612. /O<n>     Set sort flag for automatic slide shows (1=sort)
  613. /S<n>     Slideshow mode (no user interface, just slides)
  614. /T<mode>  **Set default text display mode
  615. /W<n>     **Set automatic array stream write after first Alt-W
  616. /Z<n>     Set delay in between slides in slide shows
  617. @<FILE>   Reads a list of image files from <FILE>.
  618. **Registered version only
  619.  
  620.  
  621. 8. CONFIGURATION FILE DETAILS
  622.  
  623.   Unless you know what you are doing and are familiar with GDS, please stay
  624. away from the configuration file.
  625.   GDS.CFG is set up to define all video modes for all display cards.  GDS.CFG
  626. will be read from the current directory first, and then from the execution
  627. path.  If GDS.CFG is not found in either location, the program will object.
  628.   Any semicolon found in the input stream is interpreted as a comment.  The
  629. semicolon and anything after it on the same line is ignored.  Disable lines
  630. in the configuration file by placing a semicolon in front of them.  Primarily,
  631. tabs, spaces, and blank lines are ignored.
  632.   There are two types of configuration lines.  The first defines a video mode,
  633. and the second specifies automatic command line options.  The format of the
  634. video modes is as follows:
  635.  
  636. A, B, C, D, E, F, G, H, I, J    ;optional comment
  637.  
  638. A) Name of the video card 
  639. B) Horizontal screen resolution (number of columns)
  640. C) Vertical screen resolution (number of lines)
  641. D) Number of bits per pixel (or 0 for text mode)
  642. E) AX register on INT 21h call to set video mode (see I)
  643. F) BX register on INT 21h call to set video mode (see I)
  644. G) CX register on INT 21h call to set video mode (see I)
  645. H) DX register on INT 21h call to set video mode (see I)
  646. I) This option has one of three meanings:
  647.     1) 0 if video mode is a standard graphics mode
  648.     2) 1 if video mode is directly programmed (VGA register compatible cards
  649.          only!
  650.     3) The base address of the screen if the video mode is a text mode
  651.          (indicated by 0 bits per pixel).
  652. J) Dot Mode (0=normal, 1=ATI 16-color chunky)
  653.  
  654.   **To specify automatic command line options, add a line to GDS.CFG similar
  655. to the following example:
  656.  
  657. **AUTO, /m64 /t132x44      ;limit palette to 64 colors, set text to 132x44
  658.  
  659.   **This example will behave as if you typed "/m64 /t132x44" on the command
  660. line.  All automatic command line parameters will be processed AFTER the
  661. actual command line parameters.
  662. **Registered version only
  663.   There are examples of each of these two types of command lines in the
  664. included GDS.CFG file.  There are also comments in the file which should
  665. offer more information.
  666.  
  667.  
  668. 9. COMMON PROBLEMS AND SOLUTIONS 
  669.  
  670. The following PROBLEM and SOLUTION pairs are included to help you figure
  671. out what's wrong if you are having a problem with GDS.  Each entry is the
  672. result of many phone calls from users.
  673.  
  674. PROBLEM:     After GDS starts, it keeps doing something with the disk drive
  675. which makes me paranoid!  I don't like it and I want it to stop!
  676. SOLUTION:    This inquisitive behavior is perfectly normal for GDS.  Don't
  677. worry, it's not a virus deleting your files!  GDS reads the number of bits
  678. per pixel and screen resolution for every file in the file list whenever you
  679. haven't done anything interesting for a few seconds.  It will read a few
  680. listings and then pause for a couple of seconds and repeat this pattern
  681. until it has read every file.  It does this so you don't have to wait for a
  682. long time if you want to sort by something which needs to be read from every
  683. file (like number of bits per pixel or screen resolution).  If you do
  684. anything with the user interface or hit any keys, GDS will stop reading
  685. these files instantly, and wait for a while before it starts up again.
  686.  
  687. PROBLEM:        Some pictures go totally nuts and draw lines all over the
  688. screen.  With some pictures, the screen skews horizontally and looks like
  689. the monitor isn't doing its job.
  690. SOLUTION:       Look at the resolution of the file, it may exceed the
  691. resolution of your display.  First set the resolution to the max that your
  692. system can handle, then set the "AutO" button to the "LOck" state, and then
  693. try viewing the image again.  For a permanent fix, remove the unsupported
  694. video modes in "GDS.CFG" by inserting a semicolon (";") at the beginning of
  695. the line describing the video mode.  It's a good idea to go through each mode
  696. in the "RES:" menu, write down which modes do not work with your system, and
  697. then edit the GDS.CFG to omit all of the modes which do not work.
  698.  
  699. PROBLEM:     The demo version of GDS viewed this image fine but the 
  700. registered version won't do it.
  701. SOLUTION:    The demo version will force high-resolution images down to
  702. 640x480.  Your registered copy may be trying to use a mode that you don't 
  703. have.  Either remove the offending mode from GDS.CFG so that it goes to 
  704. the next mode or lock GDS on a mode that you do have and view the image
  705. with the Alt-F to fit it to the screen.  I have actualy refunded registration
  706. fees to users that could not understand that their system would not view
  707. 1024x768.  "But the demo version worked fine!"  Sure it did, it showed the 
  708. image in 640x480.
  709.  
  710. PROBLEM:     The file cursor flashes on and off very fast on some files and
  711. GDS will not display them.  GDS displays the horizontal resolution of the
  712. file at the bottom of the screen as "-1".
  713. SOLUTION:    GDS does this because GDS believes there is an error in the file.
  714. If you don't believe there's an error in the header of the file, try
  715. displaying the file with another viewer.  FAX or write me a note if you find
  716. a file that GDS will not display, but other viewers will.
  717.  
  718. PROBLEM:     GDS won't run, and gives me an error that says it doesn't know
  719. what kind of video card I have.
  720. SOLUTION:    If you're sure you have a video card which is compatible with
  721. the listings in GDS.CFG, then use the "/<NAME>" option to tell GDS what card
  722. to use.  You may also have to use the "/512" option if you have 512K of
  723. video RAM.  If you don't know what kind of video card you have, then you
  724. probably have one which is incompatible with GDS.  If you'd like to see the
  725. card supported, send me the technical reference information with a brief
  726. cover letter.  If you really know what you're doing, you can add the modes
  727. for your board in GDS.CFG.
  728.  
  729. PROBLEM:     GDS displays the top part of 256-color images fine, but the
  730.  bottom part is either black, white, or garbled.
  731. SOLUTIONS:
  732.      A) Try locking each extended screen mode in the "Res:" menu and
  733. displaying files with it.  See which ones screw up.
  734.      B) Check to see if there is enough RAM on your video card to use the
  735. display mode you're trying to go into.  If not, you can disable the
  736. offending mode using a semicolon (";") in GDS.CFG.
  737.      C) Look in GDS.CFG to see if the screen modes which screw up are
  738. actually supported by your video card, and not by a different video card.
  739. You may have to experiment with the GDS configuration file to get a
  740. reliable list of modes to use.
  741.  
  742. PROBLEM:     Some pictures I have are squished to the left or top of the
  743. screen when I view them with GDS.
  744. SOLUTION:    Depending on the graphics mode that the image was stored in and
  745. the different graphics modes GDS supports for your video board, the aspect
  746. ratio of images can be way off.  GDS will not modify the dimensions of a
  747. picture unless the picture is TOO BIG to fit on the largest mode available
  748. (in which case, GDS will scale the image down to fit into the largest screen
  749. mode).  These squished images were probably written from a screen size which
  750. has a much greater horizontal aspect ratio than the display mode you're
  751. viewing it with.  Most of the time, you can simply hit ALT-F to fit the
  752. image into the screen.  Sometimes, however, people store the images squished
  753. into normal screen sizes.  When Alt-F doesn't work, try using the arrow
  754. keys (in registered versions, the SHIFT key makes the arrows more powerful).
  755. To actually FIX these images, just manipulate the image until it fits nicely
  756. into the screen and write the image to a new file using ALT-W.
  757.  
  758. PROBLEM:     I see garbage on the text screen around the mouse pointer
  759. whenever I move the mouse around.  It is very annoying, I hate it, it's
  760. ugly, make it go away.
  761. SOLUTION:    You must have a VGA which isn't supported by the graphic/text
  762. mouse pointer.  You can click the "MOUSE:" button on the file menu to get
  763. rid of the problem temporarily, or change "GDS.CFG" and add the line
  764. "auto, /B0".  This will force the mouse to be a character, rather than an
  765. arrow in text mode.  Many SVGA boards in extended text modes don't adhere
  766. to the same character set mapping scheme used by standard VGA 80x25 text
  767. mode.  VIDEO7 cards and GENOA cards seem to use compatible character set
  768. mapping and work without glitching in extended text modes, while many other
  769. SVGA cards display garbage around the cursor.
  770.  
  771. PROBLEM:     I can display images, but the colors are messed up, and seem
  772. to be multicolored.  Colors are just messed up in general.
  773. SOLUTION:    The number of bits in your palette DAC is probably wrong.  GDS
  774. defaults to "/C6" for 18-bit DACs (6 bits per color bar).  Try using the /C0
  775. option to force GDS to use the video BIOS.  If you are an experienced user
  776. and know you have a video board with a 24-bit DAC chip in it, try the /C8
  777. option (that gives you 24-bit color resolution).
  778.  
  779. PROBLEM:     Images are about four times dimmer than they should be.
  780. SOLUTION:    You may be lucky enough to have 24-bit DAC hardware!  Try
  781. using "/C8" on the command line (or in the configuration file).  If that
  782. doesn't work, then the DAC is probably not VGA register compatible, and
  783. you'll have to use "/C0" to force GDS to use the BIOS.
  784.  
  785. PROBLEM:     The colors that GDS is picking for arrays are not very close,
  786. sometimes erratic, and get worse after the first array image.  Sometimes GDS
  787. kicks me out to DOS during an array generation or when I try to write a file.
  788. SOLUTION:    You don't have enough RAM.  On machines with less than 450K
  789. free, GDS may have trouble shuffling all of its memory around.  Much effort
  790. has gone into making the requirements of GDS as limited as possible, but
  791. graphics processing takes a lot of memory.  You may find the amount of free
  792. memory you have by using the DOS "CHKDSK" program.  If CHKDSK reports less
  793. than 450K available at the dos prompt, GDS probably does not have enough work
  794. space.  If you can provide at least 64K of EMS (expanded), run GDS with at
  795. least 64K free, and it will make an amazing difference!
  796.  
  797. 10. ADDITIONAL CUSTOMER SUPPORT
  798.  
  799.    If you have problems which you are unable to solve after reading through
  800. the "Common Problems and Solutions" section above, you may obtain additional
  801. support by calling Phase II Electronics at (908)286-0080.
  802.    Please read the complete documentation.  Approximately 80% of the customer
  803. support calls we get are simple misunderstandings which would be more quickly
  804. resolved by reading this manual completely.  Besides, GDS probably does more
  805. than you think it does, and the only way to discover all of these wonderful
  806. features is to read this document and play with the program.
  807.  
  808. CAPABILITIES OF DIFFERENT GDS VERSIONS:
  809. ======================================
  810. Free "Demo" Distribution Version
  811. -----------------------------------------------------------
  812. Reads GIF87a, GIF89a, BMP, LBM, PCX, RIX, MAC
  813. Writes GIF87a
  814. Command Line Slide Show Functions
  815. File delete function
  816. Multiple Image Generation. Great for cataloging images
  817. ALT-F   Fit to screen function in single view mode
  818. Image scaling (x/y separate) to almost any size
  819. up to 15-bit optimized palette generation for array images
  820. Single path specification
  821. Indexes up to 512 files at once
  822. Supports video modes up to 640x480x256
  823. Medium quality antialiasing (horizontal only)
  824. Reads GDS.CFG
  825. ** Mouse controlled pull down menu's for all options while in view mode.
  826.     and many other features too numerous to mention here.
  827. **** NEW - Command line slide show options supported in the "demo"
  828. version and smaller memory requirements due to popular demand.
  829. Reads lists of path/file specifications from a file (@FILENAME);
  830.       great for slideshows.
  831.   
  832.  
  833. $35.00 Registered User Version (you should get this)
  834. ----------------------------------------------------
  835. Reads GIF87a, GIF89a, BMP, LBM, PCX, RIX, MAC, TARGA 16/24
  836. Writes GIF87a, BMP, LBM, PCX, RIX, TARGA
  837. Handles multiple path specifications, up to 2800 files at once
  838. Allows user to instantly specify new path/file lists
  839. Supports SVGA high res graphics modes above 640x480
  840. Supports 16/24-bit DAC's
  841. Instant Copy/Hide/Rename/Delete/Move file functions
  842. Allows user to toggle labels and borders in array generation
  843. Provides unattended array generation for batches of images (SYSOPS!)
  844. "+"/"-" instantly increases/decreases image size in single view
  845. ALT-Z  zoom function in single view mode lets you home in
  846. Enhanced single view image scaling (Shifted arrows move fast!)
  847. Enhanced pan feature (Shifted E, S, D, and X keys move fast!) or mouse
  848. High quality antialiasing available (professional quality)
  849. 1:3 dithering available (great for 16-color image conversion)
  850. Many valuable command line options to customize the GDS environment
  851. Image clip and save (except RIX as they don't support clips)
  852. Reads GDS.CFG & GDSUSER.CFG, to separate your customizations
  853. Reads lists of path/file specifications from a file (@FILENAME);
  854.       great for slideshows and automated array generation
  855. ** Mouse controlled pull down menu's for all options while in view mode.
  856.     and many other features too numerous to mention here.
  857.  
  858. GDSPro  $249
  859. -----------------------------------------------------------------------
  860. The Professional version of GDS presently provides full support for the 
  861. Epson ES300C flat bed 9" by 12" single pass full color scanner.  Features 
  862. such as software sharpening and area enhancement produce scanned images 
  863. of superior quality with a minimum of time and user intervention. Common
  864. palette generation and other features are also available.
  865.    Jovian support has been added and Microtek and Sharp scanner support
  866. will be available "very" soon.
  867. -----------------------------------------------------------------------
  868. You may discover other features in this Demo and the Registered version
  869. of GDS as this file is not updated as rapidly as the program is.
  870.  
  871.  
  872.                                FUTURE WATCH 
  873.  
  874.                              GDS Professional
  875.                             What do you want?
  876.                          How much should it cost?
  877.  
  878. Do you want:
  879.         More file formats?  Which?
  880.         Batch language for multiple processes?
  881.         Palette locking/translation?
  882.         Image content palette searches?
  883.         Extremely high quality photomontages?
  884.         Shell to DOS and/or paint programs?
  885.         Scanner support?
  886.  
  887.  
  888.                PLEASE LET US KNOW!
  889.  
  890.                Phase II Electronics Inc.
  891.                19 Sands Point Drive
  892.                Toms River New Jersey 08755-5167
  893.                Phone (908) 286-0080,  Fax (908) 349-3842
  894.                Compuserve 76667,1522  Bob Holland
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.